home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 003 / _filer / !Filer-_PinBrdMenu_!Help < prev    next >
Encoding:
Text File  |  1994-07-15  |  2.5 KB  |  93 lines
  1.  
  2. if not stated otherwise, all the files referred to in (and including)
  3. this !Help file are located in the !Filer-.PinBrdMenu directory
  4.  
  5.  
  6. Format of the Devices file
  7. ==========================
  8.  
  9. the Devices file is used by Maker to build Filer-'s pinboard menu
  10. 'database' (the Data file)
  11.  
  12. for each menu item, Devices must provide two lines
  13. - 'device specification' of the device associated with the item
  14. - a sprite name
  15.  
  16.  
  17. example: you want to be able to access the ADFS floppy disc drive 0
  18.          from Filer-'s pinboard menu
  19.  
  20. Devices must contain the two lines
  21.  
  22. ADFS::0
  23. f-floppy
  24.  
  25. this 'associates' a pinboard menu item with the ADFS floppy disc drive 0.
  26. if you click upon the item, the ADFS::0.$ directory will be opened.
  27. when the pointer is over it and you go ë, a Filer- menu for the ADFS::0.$
  28. directory will pop up
  29.  
  30. when the pointer is NOT over this item, the sprite f-floppy
  31. will be displayed in the pinboard menu.
  32.  
  33. when the pointer IS over the item, the sprite f-floppy'
  34. will be displayed instead.
  35.  
  36. both sprites should be defined in the Sprites file
  37. (otherwise you will see nothing or only twice as much╣ in the menu)
  38.  
  39. the sequence of items in the Devices file determines
  40. the sequence of items in Filer-'s pinboard menu
  41.  
  42. empty lines in Devices are ignored and so are leading
  43. characters with codes <= 32 (ASC" ")
  44.  
  45. a device specification is of the form:
  46.  
  47.         <filing system name>::<drive number or name>
  48.  
  49. :<drive number or name> is optional
  50.  
  51. if you omit it (can for eg. RAMFS, do not for eg. hard disc),
  52. Filer- will access the root directory ($) on the *Configure'd drive
  53. for the given filing system
  54.  
  55. a valid specification must not contain certain characters (see User Guide).
  56. this is not checked for rigorously, but the string is scanned only up to
  57. the first character <= " " and any stuff after it is ignored and can be left
  58. there as a comment. sprite names are scanned the same way
  59.  
  60. a line must not be longer than 255 characters
  61.  
  62. to create Data, 2click on !Make
  63.  
  64. hope you have good sprites
  65.  
  66. --
  67.  
  68. ╣ :-)
  69.  
  70. --
  71.  
  72. you can create Data by hand. it's plain text, typed as 'data'
  73.  
  74. the format is:
  75.                                        - this line does not belong to Data
  76. number of items (say N)
  77. device spec 1
  78. .
  79. ...
  80. .
  81. device spec N
  82. Ssprite name 1,sprite name 1'
  83. .
  84. ...
  85. .
  86. Ssprite name N,sprite name N'
  87.  
  88. the list must not contain empty lines before the 1st line and the last one
  89. each line is terminated by a line feed char (ASCII 10)
  90.  
  91. Ssprite name i,sprite name i' is nothing else but the validation
  92. string for the pinboard menu item i
  93.